Doc formatting tweaks.
authorMatthias Clasen <maclas@gmx.de>
Tue, 30 Sep 2003 22:48:10 +0000 (22:48 +0000)
committerMatthias Clasen <matthiasc@src.gnome.org>
Tue, 30 Sep 2003 22:48:10 +0000 (22:48 +0000)
2003-10-01  Matthias Clasen  <maclas@gmx.de>

* gtk/gtkmain.c: Doc formatting tweaks.

* gtk/gtktoolitem.c (gtk_tool_item_set_is_important): Fix a typo.

* gtk/gtkcheckmenuitem.h (gtk_check_menu_item_set_draw_as_radio):
Use the same parameter names as in .c file, to pacify gtk-doc.

* gtk/gtktoggletoolbutton.[hc]:
* gtk/gtktoolbutton.[hc]:
* gtk/gtktoolitem.[hc]:
* gtk/gtktoolbar.[hc]:
* gtk/gtkcolorbutton.[hc]:
* gtk/gtkfontbutton.[hc]:
* gtk/gtkalignment.[hc]: Define GET_PRIVATE macros in the
source, not in the header.

* gtk/gtkcheckmenuitem.c (gtk_check_menu_item_[sg]et_draw_as_radio):
Document these as 2.4 API additions.

* gtk/tmpl/gtkaction.sgml: Fix cross reference to GtkMenuMerge.

* gtk/gtk-sections.txt: Additions.

* gtk/tmpl/gtkitemfactory.sgml: Add hint to use #GtkUIManager instead.

24 files changed:
ChangeLog
ChangeLog.pre-2-10
ChangeLog.pre-2-4
ChangeLog.pre-2-6
ChangeLog.pre-2-8
docs/reference/ChangeLog
docs/reference/gtk/gtk-sections.txt
docs/reference/gtk/tmpl/gtkaction.sgml
gtk/gtkalignment.c
gtk/gtkcheckmenuitem.c
gtk/gtkcheckmenuitem.h
gtk/gtkcolorbutton.c
gtk/gtkcolorbutton.h
gtk/gtkfontbutton.c
gtk/gtkfontbutton.h
gtk/gtkmain.c
gtk/gtktoggletoolbutton.c
gtk/gtktoggletoolbutton.h
gtk/gtktoolbar.c
gtk/gtktoolbar.h
gtk/gtktoolbutton.c
gtk/gtktoolbutton.h
gtk/gtktoolitem.c
gtk/gtktoolitem.h

index d513bd3a1de7d730655ee90e85866626076611e9..6e250c48f59c468c215ab3276912d336b88aa114 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,24 @@
+2003-10-01  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtkmain.c: Doc formatting tweaks.
+
+       * gtk/gtktoolitem.c (gtk_tool_item_set_is_important): Fix a typo.
+
+       * gtk/gtkcheckmenuitem.h (gtk_check_menu_item_set_draw_as_radio): 
+       Use the same parameter names as in .c file, to pacify gtk-doc.
+
+       * gtk/gtktoggletoolbutton.[hc]: 
+       * gtk/gtktoolbutton.[hc]: 
+       * gtk/gtktoolitem.[hc]:
+       * gtk/gtktoolbar.[hc]: 
+       * gtk/gtkcolorbutton.[hc]: 
+       * gtk/gtkfontbutton.[hc]: 
+       * gtk/gtkalignment.[hc]: Define GET_PRIVATE macros in the 
+       source, not in the header.
+
+       * gtk/gtkcheckmenuitem.c (gtk_check_menu_item_[sg]et_draw_as_radio): 
+       Document these as 2.4 API additions.
+
 Tue Sep 30 23:42:56 2003  Kristian Rietveld  <kris@gtk.org>
 
        * gtk/gtkentry.c (gtk_entry_set_completion),
index d513bd3a1de7d730655ee90e85866626076611e9..6e250c48f59c468c215ab3276912d336b88aa114 100644 (file)
@@ -1,3 +1,24 @@
+2003-10-01  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtkmain.c: Doc formatting tweaks.
+
+       * gtk/gtktoolitem.c (gtk_tool_item_set_is_important): Fix a typo.
+
+       * gtk/gtkcheckmenuitem.h (gtk_check_menu_item_set_draw_as_radio): 
+       Use the same parameter names as in .c file, to pacify gtk-doc.
+
+       * gtk/gtktoggletoolbutton.[hc]: 
+       * gtk/gtktoolbutton.[hc]: 
+       * gtk/gtktoolitem.[hc]:
+       * gtk/gtktoolbar.[hc]: 
+       * gtk/gtkcolorbutton.[hc]: 
+       * gtk/gtkfontbutton.[hc]: 
+       * gtk/gtkalignment.[hc]: Define GET_PRIVATE macros in the 
+       source, not in the header.
+
+       * gtk/gtkcheckmenuitem.c (gtk_check_menu_item_[sg]et_draw_as_radio): 
+       Document these as 2.4 API additions.
+
 Tue Sep 30 23:42:56 2003  Kristian Rietveld  <kris@gtk.org>
 
        * gtk/gtkentry.c (gtk_entry_set_completion),
index d513bd3a1de7d730655ee90e85866626076611e9..6e250c48f59c468c215ab3276912d336b88aa114 100644 (file)
@@ -1,3 +1,24 @@
+2003-10-01  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtkmain.c: Doc formatting tweaks.
+
+       * gtk/gtktoolitem.c (gtk_tool_item_set_is_important): Fix a typo.
+
+       * gtk/gtkcheckmenuitem.h (gtk_check_menu_item_set_draw_as_radio): 
+       Use the same parameter names as in .c file, to pacify gtk-doc.
+
+       * gtk/gtktoggletoolbutton.[hc]: 
+       * gtk/gtktoolbutton.[hc]: 
+       * gtk/gtktoolitem.[hc]:
+       * gtk/gtktoolbar.[hc]: 
+       * gtk/gtkcolorbutton.[hc]: 
+       * gtk/gtkfontbutton.[hc]: 
+       * gtk/gtkalignment.[hc]: Define GET_PRIVATE macros in the 
+       source, not in the header.
+
+       * gtk/gtkcheckmenuitem.c (gtk_check_menu_item_[sg]et_draw_as_radio): 
+       Document these as 2.4 API additions.
+
 Tue Sep 30 23:42:56 2003  Kristian Rietveld  <kris@gtk.org>
 
        * gtk/gtkentry.c (gtk_entry_set_completion),
index d513bd3a1de7d730655ee90e85866626076611e9..6e250c48f59c468c215ab3276912d336b88aa114 100644 (file)
@@ -1,3 +1,24 @@
+2003-10-01  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtkmain.c: Doc formatting tweaks.
+
+       * gtk/gtktoolitem.c (gtk_tool_item_set_is_important): Fix a typo.
+
+       * gtk/gtkcheckmenuitem.h (gtk_check_menu_item_set_draw_as_radio): 
+       Use the same parameter names as in .c file, to pacify gtk-doc.
+
+       * gtk/gtktoggletoolbutton.[hc]: 
+       * gtk/gtktoolbutton.[hc]: 
+       * gtk/gtktoolitem.[hc]:
+       * gtk/gtktoolbar.[hc]: 
+       * gtk/gtkcolorbutton.[hc]: 
+       * gtk/gtkfontbutton.[hc]: 
+       * gtk/gtkalignment.[hc]: Define GET_PRIVATE macros in the 
+       source, not in the header.
+
+       * gtk/gtkcheckmenuitem.c (gtk_check_menu_item_[sg]et_draw_as_radio): 
+       Document these as 2.4 API additions.
+
 Tue Sep 30 23:42:56 2003  Kristian Rietveld  <kris@gtk.org>
 
        * gtk/gtkentry.c (gtk_entry_set_completion),
index d513bd3a1de7d730655ee90e85866626076611e9..6e250c48f59c468c215ab3276912d336b88aa114 100644 (file)
@@ -1,3 +1,24 @@
+2003-10-01  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtkmain.c: Doc formatting tweaks.
+
+       * gtk/gtktoolitem.c (gtk_tool_item_set_is_important): Fix a typo.
+
+       * gtk/gtkcheckmenuitem.h (gtk_check_menu_item_set_draw_as_radio): 
+       Use the same parameter names as in .c file, to pacify gtk-doc.
+
+       * gtk/gtktoggletoolbutton.[hc]: 
+       * gtk/gtktoolbutton.[hc]: 
+       * gtk/gtktoolitem.[hc]:
+       * gtk/gtktoolbar.[hc]: 
+       * gtk/gtkcolorbutton.[hc]: 
+       * gtk/gtkfontbutton.[hc]: 
+       * gtk/gtkalignment.[hc]: Define GET_PRIVATE macros in the 
+       source, not in the header.
+
+       * gtk/gtkcheckmenuitem.c (gtk_check_menu_item_[sg]et_draw_as_radio): 
+       Document these as 2.4 API additions.
+
 Tue Sep 30 23:42:56 2003  Kristian Rietveld  <kris@gtk.org>
 
        * gtk/gtkentry.c (gtk_entry_set_completion),
index d10847aa2c1938e133cfc52ce86351986de30ca2..5d621317c1fff1a5dcd89eed84198c905a2441f8 100644 (file)
@@ -1,7 +1,13 @@
-2003-09-30  Matthias Clasen  <maclas@gmx.de>
+2003-10-01  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/tmpl/gtkaction.sgml: Fix cross reference to GtkMenuMerge.
+
+       * gtk/gtk-sections.txt: Additions.
 
        * gtk/tmpl/gtkitemfactory.sgml: Add hint to use #GtkUIManager instead.
 
+2003-09-30  Matthias Clasen  <maclas@gmx.de>
+
        * gtk/tmpl/gtkuimanager.sgml: Add a section about empty menus.
 
        * gdk/tmpl/keys.sgml: Small addition.
index 5f2044fe709dab09619d8a2c0be719f5b4baab06..6e2f7db2a866397a72205335e409a2518e5edd88 100644 (file)
@@ -201,6 +201,7 @@ GTK_IS_ALIGNMENT_CLASS
 GTK_ALIGNMENT_GET_CLASS
 <SUBSECTION Private>
 gtk_alignment_get_type
+GtkAlignmentPrivate
 </SECTION>
 
 <SECTION>
@@ -401,6 +402,8 @@ gtk_check_menu_item_set_show_toggle
 gtk_check_menu_item_toggled
 gtk_check_menu_item_get_inconsistent
 gtk_check_menu_item_set_inconsistent
+gtk_check_menu_item_set_draw_as_radio
+gtk_check_menu_item_get_draw_as_radio
 
 <SUBSECTION Standard>
 GTK_CHECK_MENU_ITEM
@@ -537,6 +540,7 @@ gtk_clist_get_type
 <TITLE>GtkColorButton</TITLE>
 GtkColorButton
 gtk_color_button_new
+gtk_color_button_new_with_color
 gtk_color_button_set_color
 gtk_color_button_get_color
 gtk_color_button_set_alpha
@@ -552,9 +556,9 @@ GTK_TYPE_COLOR_BUTTON
 GTK_COLOR_BUTTON_CLASS
 GTK_IS_COLOR_BUTTON_CLASS
 GTK_COLOR_BUTTON_GET_CLASS
-GTK_COLOR_BUTTON_GET_PRIVATE
 <SUBSECTION Private>
 gtk_color_button_get_type
+GtkColorButtonPrivate
 </SECTION>
 
 <SECTION>
@@ -940,6 +944,10 @@ gtk_entry_get_type
 <TITLE>GtkEventBox</TITLE>
 GtkEventBox
 gtk_event_box_new
+gtk_event_box_set_above_child
+gtk_event_box_get_above_child
+gtk_event_box_set_visible_window
+gtk_event_box_get_visible_window
 <SUBSECTION Standard>
 GTK_EVENT_BOX
 GTK_IS_EVENT_BOX
@@ -976,6 +984,7 @@ GTK_IS_EXPANDER_CLASS
 GTK_EXPANDER_GET_CLASS
 <SUBSECTION Private>
 gtk_expander_get_type
+GtkExpanderPrivate
 </SECTION>
 
 <SECTION>
@@ -1048,7 +1057,6 @@ GTK_TYPE_FONT_BUTTON
 GTK_FONT_BUTTON_CLASS
 GTK_IS_FONT_BUTTON_CLASS
 GTK_FONT_BUTTON_GET_CLASS
-GTK_FONT_BUTTON_GET_PRIVATE
 <SUBSECTION Private>
 gtk_font_button_get_type
 </SECTION>
@@ -1403,6 +1411,7 @@ GTK_IS_IM_MULTICONTEXT_CLASS
 GTK_IM_MULTICONTEXT_GET_CLASS
 <SUBSECTION Private>
 gtk_im_multicontext_get_type
+GtkIMMulticontextPrivate
 </SECTION>
 
 <SECTION>
@@ -1646,6 +1655,7 @@ gtk_menu_append
 gtk_menu_prepend
 gtk_menu_insert
 gtk_menu_reorder_child
+gtk_menu_attach
 gtk_menu_popup
 gtk_menu_set_accel_group
 gtk_menu_get_accel_group
@@ -2840,6 +2850,8 @@ gtk_text_view_set_indent
 gtk_text_view_get_indent
 gtk_text_view_set_tabs
 gtk_text_view_get_tabs
+gtk_text_view_set_accepts_tab
+gtk_text_view_get_accepts_tab
 gtk_text_view_get_default_attributes
 GTK_TEXT_VIEW_PRIORITY_VALIDATE
 <SUBSECTION Standard>
@@ -2987,6 +2999,7 @@ GTK_IS_TOOLBAR_CLASS
 GTK_TOOLBAR_GET_CLASS
 <SUBSECTION Private>
 gtk_toolbar_get_type
+GtkToolbarPrivate
 </SECTION>
 
 <SECTION>
@@ -3007,9 +3020,12 @@ gtk_tool_item_set_visible_horizontal
 gtk_tool_item_get_visible_horizontal
 gtk_tool_item_set_visible_vertical
 gtk_tool_item_get_visible_vertical
+gtk_tool_item_set_is_important
+gtk_tool_item_get_is_important
 gtk_tool_item_get_icon_size
 gtk_tool_item_get_orientation
 gtk_tool_item_get_toolbar_style
+gtk_tool_item_get_relief_style
 gtk_tool_item_retrieve_proxy_menu_item
 gtk_tool_item_get_proxy_menu_item
 gtk_tool_item_set_proxy_menu_item
@@ -3021,7 +3037,6 @@ GTK_TOOL_ITEM_CLASS
 GTK_IS_TOOL_ITEM
 GTK_IS_TOOL_ITEM_CLASS
 GTK_TOOL_ITEM_GET_CLASS
-GTK_TOOL_ITEM_GET_PRIVATE
 
 <SUBSECTION Private>
 gtk_tool_item_get_type
@@ -3070,7 +3085,6 @@ GTK_TOOL_BUTTON_CLASS
 GTK_IS_TOOL_BUTTON
 GTK_IS_TOOL_BUTTON_CLASS
 GTK_TOOL_BUTTON_GET_CLASS
-GTK_TOOL_BUTTON_GET_PRIVATE
 
 <SUBSECTION Private>
 gtk_tool_button_get_type
@@ -3121,7 +3135,6 @@ GTK_TOGGLE_TOOL_BUTTON_GET_CLASS
 <SUBSECTION Private>
 gtk_toggle_tool_button_get_type
 GtkToggleToolButtonPrivate
-GTK_TOGGLE_TOOL_BUTTON_GET_PRIVATE
 </SECTION>
 
 <SECTION>
@@ -3924,6 +3937,7 @@ gtk_widget_realize
 gtk_widget_unrealize
 gtk_widget_queue_draw
 gtk_widget_queue_resize
+gtk_widget_queue_resize_no_redraw
 gtk_widget_draw
 gtk_widget_size_request
 gtk_widget_get_child_requisition
index f7aa54862483d20d99ae2dbd55831bb91a39391a..ca740fe8bccbe1223e05a0faef17a63af6e6f44f 100644 (file)
@@ -45,7 +45,7 @@ activate its action.
 
 <!-- ##### SECTION See_Also ##### -->
 <para>
-#GtkActionGroup, #GtkMenuMerge
+#GtkActionGroup, #GtkUIManager
 </para>
 
 <!-- ##### STRUCT GtkAction ##### -->
index 01ba0141881747eef464587495036de45b74a047..2751895954916f24208063d4ab3079f6d9011ffa 100644 (file)
@@ -43,6 +43,8 @@ enum {
   PROP_LAST
 };
 
+#define GTK_ALIGNMENT_GET_PRIVATE(o)  (G_TYPE_INSTANCE_GET_PRIVATE ((o), GTK_TYPE_ALIGNMENT, GtkAlignmentPrivate))
+
 struct _GtkAlignmentPrivate
 {
   guint padding_top;
index 75db42a7f5f350dd492b87b660c52dae2ac5ad66..fda72881222f7134b16a83569c157f040b6fa545 100644 (file)
@@ -322,6 +322,7 @@ gtk_check_menu_item_get_inconsistent (GtkCheckMenuItem *check_menu_item)
  *
  * Sets whether @check_menu_item is drawn like a #GtkRadioMenuItem
  *
+ * Since: 2.4
  **/
 void
 gtk_check_menu_item_set_draw_as_radio (GtkCheckMenuItem *check_menu_item,
@@ -348,6 +349,8 @@ gtk_check_menu_item_set_draw_as_radio (GtkCheckMenuItem *check_menu_item,
  * Returns whether @check_menu_item looks like a #GtkRadioMenuItem
  * 
  * Return value: Whether @check_menu_item looks like a #GtkRadioMenuItem
+ * 
+ * Since: 2.4
  **/
 gboolean
 gtk_check_menu_item_get_draw_as_radio (GtkCheckMenuItem *check_menu_item)
index 3572b7708aa2d16055f550d3433925559875c894..74b1ef133eb2f806ea5368feb1f2a72d7f5a3930 100644 (file)
@@ -87,7 +87,7 @@ void       gtk_check_menu_item_set_inconsistent  (GtkCheckMenuItem *check_menu_i
                                                  gboolean          setting);
 gboolean   gtk_check_menu_item_get_inconsistent  (GtkCheckMenuItem *check_menu_item);
 void       gtk_check_menu_item_set_draw_as_radio (GtkCheckMenuItem *check_menu_item,
-                                                 gboolean          draw_radio_indicator);
+                                                 gboolean          draw_as_radio);
 gboolean   gtk_check_menu_item_get_draw_as_radio (GtkCheckMenuItem *check_menu_item);
     
 
index b6896279d7a9efa9169506ea5ae131a1e17d12c9..c9cd5cdb7f2e906f9fedad254a78090212032c56 100644 (file)
@@ -50,6 +50,8 @@
 #define CHECK_DARK  21845  /* 65535 / 3     */
 #define CHECK_LIGHT 43690 
 
+#define GTK_COLOR_BUTTON_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_COLOR_BUTTON, GtkColorButtonPrivate))
+
 struct _GtkColorButtonPrivate 
 {
   GdkPixbuf *pixbuf;    /* Pixbuf for rendering sample */
index ed67ccfdaa6d47534d81cbc859ee8456fcfa495f..be8ec8fe7de3245187d21b89c518c3b4cbdbc566 100644 (file)
@@ -49,7 +49,6 @@ G_BEGIN_DECLS
 #define GTK_IS_COLOR_BUTTON(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_COLOR_BUTTON))
 #define GTK_IS_COLOR_BUTTON_CLASS(klass)  (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_COLOR_BUTTON))
 #define GTK_COLOR_BUTTON_GET_CLASS(obj)   (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_COLOR_BUTTON, GtkColorButtonClass))
-#define GTK_COLOR_BUTTON_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_COLOR_BUTTON, GtkColorButtonPrivate))
 
 typedef struct _GtkColorButton          GtkColorButton;
 typedef struct _GtkColorButtonClass     GtkColorButtonClass;
index 05bfc3f42a175f13a383bcb4e2664225c1e9d919..fea8f2087e2eb2950821b7766614853e850fc9cf 100644 (file)
@@ -44,6 +44,8 @@
 #include <string.h>
 #include <stdio.h>
 
+#define GTK_FONT_BUTTON_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_FONT_BUTTON, GtkFontButtonPrivate))
+
 struct _GtkFontButtonPrivate 
 {
   gchar         *title;
index 896ef335d4691b7a6f1ff07c7048d93ea766c605..8952569b90245ef38692f2e23240765af67e44d6 100644 (file)
@@ -41,7 +41,6 @@ G_BEGIN_DECLS
 #define GTK_IS_FONT_BUTTON(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_FONT_BUTTON))
 #define GTK_IS_FONT_BUTTON_CLASS(klass)  (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_FONT_BUTTON))
 #define GTK_FONT_BUTTON_GET_CLASS(obj)   (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_FONT_BUTTON, GtkFontButtonClass))
-#define GTK_FONT_BUTTON_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_FONT_BUTTON, GtkFontButtonPrivate))
 
 typedef struct _GtkFontButton        GtkFontButton;
 typedef struct _GtkFontButtonClass   GtkFontButtonClass;
index 78dc4d1c02fca6708371d481d33821e7695917c6..ea9297be321e564760a03b69818536d5c7de40b9 100644 (file)
@@ -413,8 +413,8 @@ module_build_la_path (const gchar *directory,
  * @name: the name of the module
  * @type: the type of the module, for instance 'modules', 'engines', immodules'
  * 
- * Looks for a dynamically module named @name of type @type in the standard GTK+
- *  module search path.
+ * Looks for a dynamically loadable module named @name of type @type in the
+ * standard GTK+ module search path.
  * 
  * Return value: the pathname to the found module, or %NULL if it wasn't found.
  *  Free with g_free().
@@ -611,8 +611,8 @@ display_opened_cb (GdkDisplayManager *display_manager,
 
 /**
  * gdk_parse_args:
- * @argc: the number of command line arguments.
- * @argv: the array of command line arguments.
+ * @argc: a pointer to the number of command line arguments.
+ * @argv: a pointer to the array of command line arguments.
  * 
  * Parses command line arguments, and initializes global
  * attributes of GTK+, but does not actually open a connection
@@ -847,11 +847,9 @@ gtk_parse_args (int    *argc,
 /**
  * gtk_init_check:
  * @argc: Address of the <parameter>argc</parameter> parameter of your 
- *   <function>main()</function> function. Changed if any arguments were 
- *   handled.
- * @argv: Address of the <parameter>argv</parameter> parameter of 
- *   <function>main()</function>. Any parameters understood by gtk_init() 
- *   are stripped before return.
+ *   main() function. Changed if any arguments were handled.
+ * @argv: Address of the <parameter>argv</parameter> parameter of main(). 
+ *   Any parameters understood by gtk_init() are stripped before return.
  * 
  * This function does the same work as gtk_init() with only 
  * a single change: It does not terminate the program if the GUI can't be 
@@ -878,15 +876,13 @@ gtk_init_check (int        *argc,
 /**
  * gtk_init:
  * @argc: Address of the <parameter>argc</parameter> parameter of your 
- *   <function>main()</function> function. Changed if any arguments were 
- *   handled.
- * @argv: Address of the <parameter>argv</parameter> parameter of 
- *   <function>main()</function>. Any parameters understood by gtk_init() 
- *   are stripped before return.
+ *   main() function. Changed if any arguments were handled.
+ * @argv: Address of the <parameter>argv</parameter> parameter of main(). 
+ *   Any parameters understood by gtk_init() are stripped before return.
  * 
  * Call this function before using any other GTK+ functions in your GUI
- * applications.  It will initialize everything needed to operate the toolkit and
- * parses some standard command line options. @argc and 
+ * applications.  It will initialize everything needed to operate the 
+ * toolkit and parses some standard command line options. @argc and 
  * @argv are adjusted accordingly so your own code will 
  * never see those standard arguments.
  *
@@ -989,13 +985,12 @@ gtk_exit (gint errorcode)
  * <literal>setlocale (LC_ALL, "")</literal> but also takes care of the 
  * locale specific setup of the windowing system used by GDK.
  * 
- * Return: a string corresponding to the locale set, typically in the
+ * Returns: a string corresponding to the locale set, typically in the
  * form lang_COUNTRY, where lang is an ISO-639 language code, and
  * COUNTRY is an ISO-3166 country code. On Unix, this form matches the
- * result of the <function>setlocale()</function>; it is also used on
- * other machines, such as Windows, where the C library returns a
- * different result. The string is owned by GTK+ and should not be
- * modified or freed.
+ * result of the setlocale(); it is also used on other machines, such as 
+ * Windows, where the C library returns a different result. The string is 
+ * owned by GTK+ and should not be modified or freed.
  **/
 gchar *
 gtk_set_locale (void)
@@ -1018,11 +1013,11 @@ gtk_set_locale (void)
  * 
  * On Windows, the C library doesn't use any such environment
  * variables, and setting them won't affect the behaviour of functions
- * like <function>ctime()</function>. The user sets the locale through
- * the Regional Options in the Control Panel. The C library (in the
- * <function>setlocale()</function> function) does not use country and
- * language codes, but country and language names spelled out in
- * English. However, this function does check the above environment
+ * like ctime(). The user sets the locale through the Regional Options 
+ * in the Control Panel. The C library (in the setlocale() function) 
+ * does not use country and language codes, but country and language 
+ * names spelled out in English. 
+ * However, this function does check the above environment
  * variables, and does return a Unix-style locale string based on
  * either said environment variables or the thread's current locale.
  *
@@ -1071,7 +1066,7 @@ _gtk_get_lc_ctype (void)
  * application.)  The default language is derived from the current
  * locale. It determines, for example, whether GTK+ uses the
  * right-to-left or left-to-right text direction. See
- * _gtk_get_lc_ctype for notes on behaviour on Windows.
+ * _gtk_get_lc_ctype() for notes on behaviour on Windows.
  * 
  * Return value: the default language as a #PangoLanguage, must not be
  * freed
index 02c076feedc9539635bb42ebeab8fd973b2ed40a..a994b2b9015e67e2068601730052c912c71d345f 100644 (file)
@@ -34,6 +34,8 @@ enum {
   LAST_SIGNAL
 };
 
+#define GTK_TOGGLE_TOOL_BUTTON_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_TOGGLE_TOOL_BUTTON, GtkToggleToolButtonPrivate))
+
 struct _GtkToggleToolButtonPrivate
 {
   guint active : 1;
index 341cdcbeb5d76fd3e662b25aba2649eac95649dc..0d5b1ad19d514ea6352762174c2b05f33b40c530 100644 (file)
@@ -33,7 +33,6 @@ G_BEGIN_DECLS
 #define GTK_IS_TOGGLE_TOOL_BUTTON(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_TOGGLE_TOOL_BUTTON))
 #define GTK_IS_TOGGLE_TOOL_BUTTON_CLASS(klass)  (G_TYPE_CHECK_CLASS_TYPE ((obj), GTK_TYPE_TOGGLE_TOOL_BUTTON))
 #define GTK_TOGGLE_TOOL_BUTTON_GET_CLASS(obj)   (G_TYPE_INSTANCE_GET_CLASS((obj), GTK_TYPE_TOGGLE_TOOL_BUTTON, GtkToggleToolButtonClass))
-#define GTK_TOGGLE_TOOL_BUTTON_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_TOGGLE_TOOL_BUTTON, GtkToggleToolButtonPrivate))
 
 typedef struct _GtkToggleToolButton        GtkToggleToolButton;
 typedef struct _GtkToggleToolButtonClass   GtkToggleToolButtonClass;
index bb802079c39a6f26503ef3fd01f6e5dfef12e65e..dd5e8328d5f9574fd7c096d403184a708c9091d3 100644 (file)
@@ -191,6 +191,8 @@ typedef enum {
   NEW_API
 } ApiMode;
 
+#define GTK_TOOLBAR_GET_PRIVATE(o)  (G_TYPE_INSTANCE_GET_PRIVATE ((o), GTK_TYPE_TOOLBAR, GtkToolbarPrivate))
+
 struct _GtkToolbarPrivate
 {
   GList     *items;
index fce9b7b2a0698c930fe4fd31a67d7a81c91a8382..f4e64d31de0e4d36d57c86f7674bd9d16ef3f6af 100644 (file)
@@ -55,7 +55,6 @@ G_BEGIN_DECLS
 #define GTK_IS_TOOLBAR(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_TOOLBAR))
 #define GTK_IS_TOOLBAR_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_TOOLBAR))
 #define GTK_TOOLBAR_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_TOOLBAR, GtkToolbarClass))
-#define GTK_TOOLBAR_GET_PRIVATE(o)  (G_TYPE_INSTANCE_GET_PRIVATE ((o), GTK_TYPE_TOOLBAR, GtkToolbarPrivate))
 
 #ifndef GTK_DISABLE_DEPRECATED
 typedef enum
index 5382b7d11d27ae108aa14b59a817bac796489959..8fe2b6b74c9166afb4bbd796854a3be822aae21d 100644 (file)
@@ -76,6 +76,8 @@ static void gtk_tool_button_construct_contents (GtkToolItem *tool_item);
 static GObjectClass *parent_class = NULL;
 static guint         toolbutton_signals[LAST_SIGNAL] = { 0 };
 
+#define GTK_TOOL_BUTTON_GET_PRIVATE(obj)(G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_TOOL_BUTTON, GtkToolButtonPrivate))
+
 struct _GtkToolButtonPrivate
 {
   GtkWidget *button;
index 591857aa43c250a6d9513df124073d17fd6866ef..236905bb416b5be5aad76dbc1b28ff5db349b1e5 100644 (file)
@@ -33,7 +33,6 @@ G_BEGIN_DECLS
 #define GTK_IS_TOOL_BUTTON(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_TOOL_BUTTON))
 #define GTK_IS_TOOL_BUTTON_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((obj), GTK_TYPE_TOOL_BUTTON))
 #define GTK_TOOL_BUTTON_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS((obj), GTK_TYPE_TOOL_BUTTON, GtkToolButtonClass))
-#define GTK_TOOL_BUTTON_GET_PRIVATE(obj)(G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_TOOL_BUTTON, GtkToolButtonPrivate))
 
 typedef struct _GtkToolButton        GtkToolButton;
 typedef struct _GtkToolButtonClass   GtkToolButtonClass;
index a75cd6232aff567bdc65fa95da238a5077b44bd2..3f6652001f89f98d1400ebbfdf468d1d70da042a 100644 (file)
@@ -43,6 +43,8 @@ enum {
   PROP_IS_IMPORTANT
 };
 
+#define GTK_TOOL_ITEM_GET_PRIVATE(o)  (G_TYPE_INSTANCE_GET_PRIVATE ((o), GTK_TYPE_TOOL_ITEM, GtkToolItemPrivate))
+
 struct _GtkToolItemPrivate
 {
   gchar *tip_text;
@@ -779,7 +781,7 @@ gtk_tool_item_get_is_important (GtkToolItem *tool_item)
 /**
  * gtk_tool_item_set_is_important:
  * @tool_item: a #GtkToolItem
- * @is_imporatnt: whether the tool item should be considered important
+ * @is_important: whether the tool item should be considered important
  * 
  * Sets whether @tool_item should be considered important. The #GtkToolButton
  * class uses this property to determine whether to show or hide its label
index ea5d4c642a65eb41105aba6d482a6d1194f30915..9d9b34ecc23fd1e7d075ffcb55ba5b2342bfa5bf 100644 (file)
@@ -33,7 +33,6 @@
 #define GTK_IS_TOOL_ITEM(o)           (G_TYPE_CHECK_INSTANCE_TYPE ((o), GTK_TYPE_TOOL_ITEM))
 #define GTK_IS_TOOL_ITEM_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((o), GTK_TYPE_TOOL_ITEM))
 #define GTK_TOOL_ITEM_GET_CLASS(o)    (G_TYPE_INSTANCE_GET_CLASS((o), GTK_TYPE_TOOL_ITEM, GtkToolItemClass))
-#define GTK_TOOL_ITEM_GET_PRIVATE(o)  (G_TYPE_INSTANCE_GET_PRIVATE ((o), GTK_TYPE_TOOL_ITEM, GtkToolItemPrivate))
 
 typedef struct _GtkToolItem        GtkToolItem;
 typedef struct _GtkToolItemClass   GtkToolItemClass;